<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
		<title>开放平台</title>
		<link rel="stylesheet" href="/api/css/style.css" type="text/css" />
		<script type="text/javascript" src="/api/js/dute-1.0.js"></script>
		<script type="text/javascript" src="/api/js/jquery-1.7.1.min.js"></script>
		<script>$($Dutement.init);</script>
	</head>
	<script>
	Page({
	  data:{	    
	  },
	  onLoad: function(options) {
	  }
	})
	</script>
	<body style="display:none;">
	
		<div>
	
		<include src="/api/header.html"></include>
		
		<div id="bd">
			<div class="div">
				<div class="title">
					<span>文档中心</span>
				</div>
			</div>
			
			<div class="div">
				<div class="catalog">
					<ul>
						<li>
							<p class="p1">
								<span></span>
								<a href="#0">开发文档</a>
							</p>
							<ul>
								<li>
									<p class="p2">
										<span></span>
										<a href="#1">必要条件</a>
									</p>
								</li>
								<li>
									<p class="p2">
										<span></span>
										<a href="#2">环境介绍</a>
									</p>
								</li>
								<li>
									<p class="p2">
										<span></span>
										<a href="#3">调用说明</a>
									</p>
								</li>
								<li>
									<p class="p2">
										<span></span>
										<a href="#4">用户授权</a>
									</p>
								</li>
							</ul>
						</li>
						<li></li>
						<li></li>
						<li></li>
					</ul>
				</div>
				<div class="artcile">
					
					
					
<h1 id="0"><strong>开放平台简介</strong></h1>
<div>开放平台（ Open Platform）是基于系统业务的开放平台，提供外部合作伙伴参与服务用户的各类原数据，例如API、账号体系、数据安全等。是大基础服务的重要开放途径。开放给有需要的合作商、开发者。</div>

<h1 id="1"><strong>必要条件</strong></h1>
<div>任何数据接入者都必须具备一定的互联网应用开发能力，必须了解http、网络程序开发相关语言、JSON格式数据等相关概念。<br />
任何数据接入者都必须得到的授权，并得到分配的开放平台接入帐号。</div>

<h1 id="2"><strong>环境介绍</strong></h1>
<div>测试环境：{{basePath}}api/invoke.do<br />
正式环境：{{basePath}}api/invoke.do</div>


<h1 id="3"><strong>调用说明</strong></h1>
<div> 调用API ，必须传入系统参数和应用参数。系统参数详细介绍如下；应用参数则根据不同API 具体入参，更多请参考API 文档。<br />
  <h2 id="ss2"><strong>1、系统参数</strong></h2>
  <table class='grid' width="100%" border="0" cellspacing="1" cellpadding="10">
  <tr>
    <td width="80">名称</td>
    <td width="80">类型</td>
    <td width="80">是否必须</td>
    <td>描述</td>
  </tr>
  <tr>
    <td width="80">method</td>
    <td>string</td>
    <td>是</td>
    <td>API接口名称，同时调用多个接口，多个接口之间用半角逗号分开</td>
  </tr>
  <tr>
    <td width="80">timestamp</td>
    <td>string</td>
    <td>是</td>
    <td>时间戳，格式为yyyy-mm-dd HH:mm:ss，例如：2015-01-01 13:52:03。API服务端允许客户端请求时间误差为10分钟。</td>
  </tr>
  <tr>
    <td width="80">appid</td>
    <td>string</td>
    <td>是</td>
    <td>分配给接入者的接入帐号</td>
  </tr>
  <tr>
    <td width="80">token</td>
    <td>string</td>
    <td>否</td>
    <td>当某些接口需要授权时需要传入用户的token,不需要时传空</td>
  </tr>
  <tr>
    <td>params</td>
    <td>string</td>
    <td>是</td>
    <td>应用参数集，根据method对应不同的接口，拼成{key:value,...}格式的json串，多个接口同时调用时拼成[{key:value,...},{key:value,...},...]格式的json串(注意与接口位置对齐)</td>
  </tr>
  <tr>
    <td>sign</td>
    <td>string</td>
    <td>是</td>
    <td>对 API 调用参数（除sign,lat,lng外）进行 md5 加密获得。具体方法参考开放平台参数签名</td>
  </tr>
  <tr>
    <td>lng</td>
    <td>Double</td>
    <td>否</td>
    <td>经度</td>
  </tr>
  <tr>
    <td>lat</td>
    <td>Double</td>
    <td>否</td>
    <td>纬度</td>
  </tr>
</table>

<h2 id="ss2"><strong>2、应用参数</strong></h2>
  请参考API文档说明
  
  <h2 id="ss2"><strong>3、签名sign</strong></h2>
 调用API 时需要对请求参数进行签名验证，开放平台服务器也会对该请求参数进行验证是否合法的。方法如下：<br/>

      根据参数名称（除签名和图片）将所有请求参数按照字母先后顺序排序:key + value .... key + value<br/>
      例如：将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1，参数名和参数值链接后，得到拼装字符串bar2baz3foo1<br/>

      系统只支持MD5加密方式:<br/>
      md5：将secret 拼接到参数字符串头、尾进行md5加密后，再转化成大写，格式是：byte2hex(md5(secretkey1value1key2value2...secret))<br/>
     
      注：hex为自定义方法，JAVA中MD5是对字节数组加密，加密结果是16字节，我们需要的是32位的大写字符串<br/>
  
 				
					
				</div>
			</div>
		
		</div>
		
		<include src="/api/footer.html"></include>
		
		</div>
	</body>
</html>